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ProSang introkurs 


PROJEKT 




W 




Project 


Donor Administration 


► Source Packages 

► QJ Test Packages 

► Cd Other Sources 

► Cd Other Test Sources 

► Cd Libraries 

► _d Test Libraries 

▼ Gfij Important Files 
► gj XML Layer 

[•) Module Manifest 
{*? Module Descriptor 

▼ ^ Project Files 

13) pom.xml 
2) settings.xml 


Files 


Donor Administration 


▼ sre 

▼ Lj main 

► £j java 

► L_ nbm 

► resources 

▼ u test 

► E_i java 

► resources 
► CJ target (Ignored 1 

H) nb-configuration, xml 
13) nbactions.xml 
(3) pom.xml 


Filstrukturen i mavenprojekt ser i princip alltid lika ut. I NetBeans visas en projektvy dar olika 
typer av kataloger fran vara projekt grupperas ihop. NetBeans har ocksa en filvy dar man kan 
se hur katalogerna och filerna faktiskt ar ordnade pa harddisken. 

Source Packages innehaller sjalva javaklasserna. Har finns aldrig nagot annat an javaklasser 

Test Packages innehaller javaklasser med unittester for klasserna fran Source Packages 

Other Sources innehaller resurser.T.ex. textfiler, xml-filer, .properties-filer, bilder. 

Other Test Sources resurser som bara behovs for unittesterna. 

Libraries ar ingen riktig katalog utan visar projektets externa beroenden. De faktiska 
beroendeposterna ar listade med <dependency>-block i projektets pom.xml 

Test Libraries samma sak men innehaller de bibliotek som bara behovs nar testerna kors. 

Important Files - NetBeans RCP-specifika konfigurationsfiler. layer.xml som later oss 
publicera funktioner i vara moduler sa att de kan anvandas av NetBeans RCP. 

Project Files - Mavens konfigurationsfiler, pom.xml ar fran projektet men settings.xml ar en 
genvag till din lokala installningsfil som egentligen ligger i $HOME/.m2/settings.xml 
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ProSang introkurs 


NETBEANS 



ProSang-klienten ar byggd ovanpa NetBeans RCP (Rich Client Platform). NetBeans RCP ar en 
opensourceplatform for att bygga grafiska Javaapplikationer som ags och utvecklas av Sun/Oracle. 
Utvecklingsmiljon NetBeans IDE bygger precis som ProSang pa NetBeans RCP. 

En applikation som skrivs for NetBeans RCP ar uppbygd av smadelar som kallas moduler 


(.n.bm -filer).. 

ProSang 


1-1 

-1 

Givar- | 

administration 


Givarbokning 

1-1 

-1 

Inloggning 


Skarm- 

komponenter 

1-1_ 

-1 

Dialog-API 


Fonster- 

hantering 


Skarmar 


Stodmoduler 


00 

m 

J3 

O 

m 


D 

m 


NetBeans RCP 


I ProSang ar modulerna uppdelade i olika kluster.Vi har ett kluster som heter Core som 
innehaller moduler med komponenter och API.er som ar gemensamma for hela ProSangklienten. 

For varje rutin (Administration, Givare, Patient etc.) finns sedan ett eget kluster. Modulerna 
som innehaller sjalva skarmarna skall inte dela med sig nagon funktionalitet till andra moduler 
Gemensam funktionalitet som bara beror modulerna i ett kluster placeras i en modul som heter 
common i klustret. Funktionalitet som ar generell for hela klienten placeras i olika moduler under 
core-klustret. Exempel pa det ar ProSangs sok-API, resultat-API. 

Moduler har ett rikare stod for att tala om vilka klasser som ar till for omvarlden an vanliga 
jar-filer. Man bor bara dela ut de paket som innehaller genomtankta publika API.er.Vilka paket som 
ar publika staller man in i modulens pom.xml 


<plugin> 

<groupId>org.codehaus.mojo</groupId> 

<artifactld>nbm-maven-plugin</artifactld> 

<extensions>true</extensions> 

<configuration> 

<publicPackages> 

<!-- All other packages are private to the module --> 
<item>se.databyran.prosang.mymodule.package.**</item> 
</publicPackages> 
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ProSang introkurs 


PROG RAMA 



ProSang bestar av en mangd delprogram 
som tillhandahaller olika funktioner till olika 
personer pa blodcentralen. Sadana 
delprogram kallas for atgardskoder efter 
den kod de startas med. En sadan kod kan 
se ut sahar t.ex. ”G 100”. G star for 
Givarrutin och 100 ar en unik identifierare 
for vilket givarprogram det handlar om. 

Varje atgardskod i ProSang ar 
implementerad med en subklass till Program 
som talar om vilken kod.vilken ikon och vad 
programmet heter. Klassen har ocksa en 
metod som anropas nar atgardskoden 
startas och som oppnar sjalva skarmen for 
atgardskoden. 

For att ProSang skall hitta programmet 
och visa det i programtradet maste 
programklassen registeras som 
implementation av SPI:t (Service Provider 

Interface) i en fil under META-INF/services som heter samma sak som sjalva SPI-interfacet den 
implementerar. 

For ett program heter filen sahar: 



META-INF/services/se.databyran.prosang.client.core.program.spi.Program 


Registreringsraden for ett program i filen kan se ut sahar: 
se.databyran.prosang.client.add ressbook.AddressBookProgram 


Samma modul kan innehalla flera program, de listas i samma fil med en ny rad for varje 
program. I NetBeans hittar du registreringsfilen under‘Other Sources’: 

▼ tub Donor Administration (nbm) 

► [J3 Source Packages 

► Ld Test Packages 
▼ Cg Other Sources 

► [j nbm 

▼ Lo src/main/resources 
▼ Ld META-INF.services 

□ se.databyran. prosang.dient.core. program, spi. Program 
[j se.databyran.prosang.model.spi.user.AccessPermissionManager 
► i_J se.databyran.prosang.client.donor.administration alerts 
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ProSang introkurs 


Programmet 

Hello World! 

Sag att vi holl pa att skriva programmet ”G00l Adressboksprogrammet”, da skulle var 
programklass kunna se ut sahar: 


public class AddressBookProgram extends Program { 

public Programld getProgramId() { 

return new ProgramId(ProgramCategory.DONOR, "001"); 

} 

public String getLabelO { 

return "Addressboksprogrammet"; 

} 

protected IconType getlconO { 

return IconType.ADDRESSSMALL; // hittepa 

} 

public String getDescription() { 

return "Hantera addresser till vanner och bekanta"; 

} 

protected void startProgram() { 

System.out.println("Hello world!"); 

} 




ProSang introkurs 


I18N ar en 
forkortning for 
internationalization 
som innehaller 18 
bokstaver mellan I 
och N. 

.properties-filerna 
syntax kommer fr£n 
javas klassbibliotek 
och kan lasas och 
skrivas med klassen 
Properties. 

Locale ar en 
kombination av land 
och spr£k (vissa 
lander har flera 
sprak) som t.ex. kan 
se ut sa har for 
sverige ”sv_SE” 


I 18 N 

Alla strangar som visas for anvandaren i ProSang maste internationaliseras. 
Java har inbyggt stod for internationalisering med Bundle-APl.t men vi 
anvander ett bibliotek ovanpa det som kommer fran NetBeans RCP. Sjalva 
texterna ligger i enkla textfiler med nyckel och text till varje strang. Varje sprak 
vi har stod for finns i en separat sadan fil for varje java-paket i ProSang. 

Filnamnet talar om vilket sprak som finns i den, med undantag for den 
propertiesfil som inte har nagot sprak palagd och som ar standardspraket som 
java faller tillbaka pa att anvanda ifall en nyckel saknas i spraket applikationen 
kors pa.Alla vara sprakfiler skall ha ett namn som borja med ’’Bundle”. 

Bundle.properties innehaller engelska, vilket kan tyckas lite markligt 
jamfort med gamla prosang men tanken ar att det skall underlatta den dagen vi 
behover oversatta till ett sprak utanfor norden. 


▼ to Donor Admnistf ibon 


► ua Source Packages 


► ua Test Packages 


▼ t Ocher Sources 


► Q nbm 


▼ Cd src/mam/resources 


► |jfi MLTA-INf.services 


▼ se.daub^tan.prosang clem.donor.admtmstr 

dton.j*fts 

► ^ Bundle propertys 


► Bundle_da properties 


► *5 Bundlejx> properties 


► afi Bund* sv.SE.properties 



Java anvander den locale som 
systemet ar installt for men man kan 
ocksa trumfa det med en flagga som 
man skickar med nar man startar en 
javaapplikation for att kora ett 
program pa norska aven om man kor 
datorn pa svenska. Localen anvands 
ocksa for att t.ex. formatera datum 
och tid pa ratt satt. 


Bundle.properties: 

MyTopComponent.title=My Top Component 

MyTopComponent.countField.text=There are {0} items in the list 

BundlesvSE.properties: 

MyTopComponent.title=Min toppkomponent 

MyTopComponent.countField.text=Det finns {0} saker i listan 


For att lasa filen anvander man sedan NbBundle.getMessage(Class class, String keyName) 


NbBundle.getMessage(MyTopComponent.class, "MyTopComponent.title"); // N0I18N 
NbBundle.getMessage(MyTopComponent.class, 

"MyTopComponent.countField.text", // N0I18N 
5); 


Strangar som ligger i kallkoden men som inte skall oversattas skall markeras med // NOII8N pa 
sa satt kan vi hitta strangar som vi missat att oversatta. Bundlenycklarna skall borja pa klassen de 
anvands i och sedan vara nagon form av objektsokvag till faltet som innehaller texten. 
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ProSang introkurs 


Loggning 

Ibland vill man skriva ut lite sparutskrift fran sitt program. I java finns 
System.out.println som skriver en rad till standard out. Den skall man aldrig 
anvanda, istallet skall man anvanda Log4J som ar det log-paket vi anvander for 
utskrift. 

Fordelen med att anvanda ett logpaket for utskrifter ar att de vet var i 
koden logmeddelandet kom ifran och att de gar att styra och konfigurera pa 
olika satt. 


Logniva 

Beskrivning 

ERROR 

Fel som inte gar att kringa pa nagot satt och 
som leder till att programmet kraschar eller 
blir funktionsodugligt 

WARN 

Fel som programmet hanterar pa nagot satt 
men som borde atgardas 

INFO 

Tex. hur en komponent ar konfigurerad, nar 
applikationen startas 

DEBUG 

Sparutskrifter som inte ger sa mycket data. 

TRACE 

Sparutskrifter som inte ger massvis med 
data.T.ex. fran insidan av en for-loop. 


Java innehSHer ett 
eget log-API som ar 
lite osmidigare att 
anvanda an Log4j. 
Dessutom ar Log4j 
integrerat med 
JBoss som ar v£r 
applikationsserver. 


Loggningen knyts till vilken klass den kommer fran nar man skapar sin 
logger. I en konfigurationsfil styr man sedan vilka loggers meddelanden som 
skall skrivas till vilken logfil och vilka nivaer som skall filtreras bort. 

I ProSang-projektet finns en Log4J-konfiguration for utveckling som ligger i 
applikationsprojektet. Man kan ocksa ansluta till en JMX-bona i ProSang- 
klienten for att stalla lognivaer i runtime. Pa serversidan finns en 
konfigurationsfil per serverinstans dar man kan stalla lognivaer. Aven dar kan 
man ansluta till en JMX-bona for att stalla lognivaer i runtime. 


public class MyClass { 

private static final Logger LOGGER = 

Logger.getLogger(MyClass.class); 

public void myMethodO { 

LOGGER.info(”Entered my method"); // N0I18N 

try { 

someOtherMethod(); 

} catch (OtherMethodException ex) { 

LOGGER.warn("Something failed", ex); // N0I18N 

} 
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ProSang introkurs 


Programmet 
Hello World! version 2 


public class AddressBookProgram extends Program { 


private static final Logger LOGGER = 

Logger.getLogger(AddressBookProgram.class); 

public Programld getProgramld() { 

return new ProgramId(ProgramCategory.DONOR, "001"); // N0I18N 

} 


public String getLabelO { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.label"); // N0I18N 


} 


protected IconType getlconO { 

return IconType.ADDRESSSMALL; 

} 


public String getDescription() { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.description"); // N0I18N 


} 


protected void startProgram() { 

LOGGER.info("Hello World!!!"); // N0I18N 

} 




ProSang introkurs 


STDRIVEN 



Att arbeta testdrivet innebar i princip att man aldrig skriver nagon kod som inte 
ar till for att fa ett test att ga igenom. Genom att borja med ett ett grundlaggande 
test och sedan skriva kod som far testet att ga igenom och sedan utoka testet 
med komplexare och komplexare krav pa funktionalitet sa hjalper man sig sjalv 
och andra pa ett antal satt: 

• Det blir ett kvitto pa att det man kodat faktiskt fungerar, som till skillnad 
fran ett manuellt test gar att aterupprepa kontinuerligt och dessutom 
oerhort mycket snabbare varje gang 

• Det blir ett skyddsnat for dig sjalv och andra som visar att ny funktionalitet 
inte fostor nagot som fungerade forut 

• Det ar en form av dokumentation som visar hur ditt publika API ar tankt 
att anvandas 

• Det hjalper dig att tanka som en konsument av den tjanst du halier pa att 
implementera, ar mitt publika API verkligen vettigt att anvanda? 

• Testbar kod ar ofta kod som ar battre designad an kod som inte gar att 
testa. 

Darfor ar det extremt viktigt att du hela tiden fosoker arbeta testdrivet. 

En testmetod skall vara isolerad och inte paverkas av andra tester och inte 
heller paverka andra tester.Testet skall namnges sa att det gar att utlasa som den 
funktion det testar. 


import static org.junit.Assert.*; 
public class MyClassTest { 

@Test 

public void beforeAnySearchHasBeenPerformedTheResultIsNull() { 

Searcher instance = new SearcherO; 

String result = instance.getResult(); 

assertNotNull(result); 

} 


For att unittesta vara klasser anvander vi JUnit 3 och 4 som ar val 
integrerade med NetBeans IDE och Maven. 

Testerna kors varje gang projektet byggs och pa sa satt kan vi vara sakra pa 
att vi upptacker fel som vi skapar i kod som forut fungerat utan att manuellt 
validera funktioner varje gang vi andrar nagot. 

Testerna kors ocksa pa var ci-server http://smith.databyran.local:9000/ 
hudson efter varje incheckning till kallkodsrepositoriet. 
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ProSang introkurs 


SKAPAENSKARM 


ProSangTopComponent 

s 





Program 


ProgramTopComponent 



A 





MyProgram 


MyTopComponent 



Begreppet 
TopComponent 
kommer fr3n 
NetBeans RCP som 
har en egen 
fonsterhanterare 
som skoter de 
interna fdnstren i en 
NetBeans RCP- 
applikation. 


Nastan varje program i ProSang har en skarm.Varje sadan skarm arver 
ProgramTopComponent. 

NetBeans guide for att skapa topkomponenter lagger till en massa text i olika 
konfigurationsfiler som vi inte vill ha och vi har ingen egen mall for 
topkomponenter. Istallet skapar man en nyJPanel (som man kallar 
MittProgramNamnTopComponent) och andrar sa att den arver 
ProgramTopComponent i java-koden. 
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ProSang introkurs 


Programmet 

Skapa och starta skarmen 


public class AddressBookProgram extends Program { 

public Programld getProgramld() { 

return new ProgramId(ProgramCategory.DONOR, "001");; 

} 

public String getLabelO { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.label"); 

} 

protected IconType getlconO { 

return IconType.ADDRESSSMALL; 

} 

public String getDescription() { 

return NbBundle.getMessage(AddressBookProgram.class, 

"AddressBookProgram.description"); 

} 

protected void startProgram() { 

ProgramTopComponent topComponent = new AddressBookTopComponent(); 
run(topComponent); 

} 



Topkom ponenten 


public class AddressBookTopComponent extends ProgramTopComponent { 


public AddressBookTopComponent() { 
initComponents(); 

setModel(presentationModel); 
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ProSang introkurs 


KOM PON ENTER 


ProSangs specialkomponenter 


Komponent 

Beskrivning 

ProSangSimpleList 

En tabell med data for visning, enkelt 

API for knappar som utfdr operationer 
pa lisfan 

ProSangTexfField 

Textfalt med funkfioner for 
formattering, validering och notifiering 

ProSangDatePickerField 

Datumvaljare med kalender 

DefinitionSelector 

Autokompletekombobox for 
definitioner 

EnumSelector 

Autokompletekombobox for enums 

ProSangDualList 

Tva listor, en med mojligt urval och en 
med de som dr valda. 


De fiesta komponenterna i ProSang 
kommer fran modulerna Client 
Modules/Core Utilities och Client 
Modules/Core Components. For att 
kunna rita skarmar med ProSangs 
specialkomponenter maste du sjalv 
lagga till dem genom att i skarmritaren 
hogerklicka pa paletten och valja 
’’Palette Manager”. 

Skapa sedan en kategori som heter 
ProSang som du kan placera alia 
ProSang-komponenter i och latt hitta 
dem. 

Klicka sedan pa ’’Add from jar...”, 
leta upp jarfilen for ’’Core Utilities” pa 
din harddisk. Nar du valt jarfilen 
kommer du fa upp en jattelang lista med klassnamn. NetBeans kan inte skilja pa vilka klasser 
som ar skarmkomponenter och vilka som ar vanliga klasser sa du far leta fram 
komponenterna du vill lagga till. Listan ovan ar en bra startpunkt. 

Gor samma sak med Core Components. 


Pakcte 


oo 


ProSang 

Paste Item 

S**ng Containers 

S«*ng Corttrolt 

Create New Category 

Sww>g Menus 

Delete Category 

Wng W»mJow\ 

Rename Category 

AWT 

Sort by Item Name 


Sort by Category Name 

Ptrsisttnct 

Refresh Palette 


Hide Item Names 

Show Big Icons 

Reset Palette 


Palette Manager... 
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ProSang introkurs 



EROMS 








PresentationModel 


Alla skarmar med data och knappar kan sagas ha ett tillstand.Tillstandet kan 
vara en lista med objekt som syns i skarmen eller om en knapp gar att klicka 
pa. Det ar ocksa operationer som knappar utfor. 

For att underlatta testning och spaghetti-kod i skarmklasserna 
representerar vi alltid skarmens innehall och tillstand med en subklass till 
StandardPresentationModel. 

FormState 

Alla skarmar med data som gar att forandra pa nagot satt har ett 
skarmtillstand.Vi har gjort en representation av detta med klassen FormState. 

Ett formstate kan vara oforandrat, andrat, innehalla fel eller bade vara 
andrat och innehalla fel. Ofta skall t.ex. en ok-knapp vara omojlig att klicka pa 
om inget andrats eller om nagot andrats men skarmen innehaller ett fel. 

FormState gor det mojligt for vara skarmar att kontinuerligt veta om de 
innehaller fel och forhindra att man ens kan klicka pa t.ex. Ok-knappen sa lange 
skarmen inte innehaller andringar eller innehaller fel. 


public class AddressBookTopComponent extends ProgramTopComponent { 


public AddressBookTopComponent() { 
initComponents(); 

FormState formstate = new MockFormState(); 
setFormState(formState); 
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ProSang introkurs 


Listor 

Glazed Lists 



I manga skarmar vill vi ha flltrering av tabeller och mojliga val i komboboxar. Vi vill ocksa 
kunna forandra listors innehall sa att listor som finns i skarmen uppdateras. 

De listor som finns i javas klassbibliotek saknar stod for det.Vi anvander darfor ett 
bibliotek som heter Glazed Lists som utokar javas Collection-API med listor som avfyrar event 
nar objekt i listan laggs till, flyttas eller tas bort (med lite special aven om egenskaper pa objekt 
i listan andras) 

Vara tabeller ar helt byggda kring glazed lists listor. 

Eventlistpaketet anvander tradar bakom kulisserna sa for att gora dem tradsakra behover 
du lasa dem innan du forandrar dem, annars kan du fa konstiga tradfel eller 
ConcurrentModificationException. 


EventList<Person> addressBook = new BasicEventList(); 


public void clearAddressBook() { 

addressBook.getReadWriteLock().writeLock().lock(); 
addressBook.clear(); 

addressBook.getReadWriteLock().writeLock().unlock(); 

} 


15 


















ProSang introkurs 


Filtrering 



EventList<Person> addressBook = new BasicEventList(); 

EventList onlyAPersons = new FilterList(list, new Matcher<Person>() { 

public boolean matches(Person person) { 

return person.getName().startsWith("A"); 

} 

}) 


Om man har en statisk filtrering (dar det man filtrerar med inte forandras) satter man en 
matcher pa sin filterlista. 

Nar man vill ha ett formular som filtrerar om listan gor man det med en MatcherEditor. 
MatcherEditorn skapar en ny Matcher och informerar listan om att sokvilkoren forandrats sa 
att listan filtreras om. Man kan aven satta en ny Matcher pa filterlistan direkt om man har 
tillgang till den. 


private FilterList<Person> addressBook = ... 


private void setSearchText(String searchText) { 

addressBook.setMatcher(new NameMatcher(searchText)); 

} 
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ProSang introkurs 


TableFormat 

Hur skall tabellen se ut? 

For att styra vilka kolumner som skall finnas i en tabell skapar man en 
ColumnsTableFormat och i den stoppar man enTableColumn for varje kolumn som tabellen 
skall ha. 


Kolumnens innehal] 


private ProSangTableFormat createTableFormat() { 

TableColumn nameColumn = new TableColumn<Address, String>( 

"Namn", \ 

50, \ 

String.class) { ^- Tabellens mnehall 

public String getValue(Address address) { 
return address.getName(); 

} 


TableColumn streetColumn = new TableColumn<Address, String>( 
"Gata", 

50, 

String.class) { 


} 


public String getValue(Address address) { 
return address.getStreet(); 

} 


return new ColumnsTableFormat<Address>(new TableColumn[] { 

nameColumn, streetColumn}); 


Manga tabellkolumner aterkommer i flera tabeller, sadana kolumner for t.ex. givare kan du 
hitta i modulerna Donor Common eller Core Tables. Om du skapar en kolumn som du kan 
tanka dig kommer behovas pa fler stallen,tanl< pa att stoppa den i nagon av de moduerna! 
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ProSang introkurs 


ProSangSimpleList 

Koppla ihop listan med skarmen 

For att visa en lista i skarmen anvander vi var egen komponent ProSangSimpleList. Du 
satter upp innehallet i din skarm i konstruktorn. Eftersom listan avfyrar event nar innehallet 
forandras skall du gora detta aven om din lista far data forst senare. 


public class AddressBookTopComponent extends ProgramTopComponent { 

public AddressBookTopComponent() { 
initComponents(); 

addressSimpleList.setup(model.getAddresses(), createTableFormat()); 

} 


ProSangSimpleList ar forberedd med de vanligaste knapparna (lagg till, ta bort och 
redigera). Sa for att skapa en sadan lista registrerar man bara olika callbacks for lagg till och 
andra.Ta bort kan den skota helt sjalv men du kan behova skapa en ObjectRenderer for att 
gora om raden som tas bort till en anvandarvanlig text (”Vill du verkligen ta bort..”). 

Om man har mer specifika knappbehov sa kan man implementera interfacet 
ButtonDescription och skicka in till sin ProSangSimpleList. 


public class AddressBookTopComponent extends ProgramTopComponent { 

public AddressBookTopComponent() { 
initComponents(); 


addressSimpleList.setItemCreator(new ItemCreator() { 
public Object create() { 

// TODO show a dialog 

} 

} 

addressSimpleList.setItemEditor(new ItemEditorO { 
(aOverride 

public Object edit(Object original) { 

// TODO copy object, show dialog 

} 

}); 

} 
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ProSang introkurs 


DIALOGA 



DialogFactory ar ett 
lite olyckligt namn 
eftersom det inte 
alls ar nSgon 
factory utan snarare 
en statisk 
utilityklass. Bakom 
kulisserna anropar 
den NetBeans 
platforms dialog 
API. 


Dialogfabriken 

For att alia dialoger i ProSang skall se likadana ut sa skall alia knappar visas 
med hjalp av klassen DialogFactory. For enkla dialoger som sadana med en 
fraga och ett par knappar finns sarskilda metoder. I de fall en mer komplicerad 
dialog behover visas kan man skicka in en egen panel till DialogFactory, panelen 
innehaller da inte knapparna som skall finnas i nederkanten av dialogen utan 
dem skickar man med som ett separat argument till DialogFactory. 

Precis som skarmar har dialoger med egna paneler ett skarmtillstand 
(FormState) som t.ex avgor om man kan klicka pa ok eller inte. For att 
automatiskt knyta ihop en panel med dialogknapparna 


// simple dialogs 

DialogResult result = DialogFactory.yesl\loCancelDialog("titel", "fraga"); 
if (result == DialogResult.YES) { 

// save 

) 


boolean yes = DialogFactory.yesNoDialog("titel" / "fraga"); 


boolean ok = DialogFactory.okCancelDialog("titel", "pastaende"); 


DialogFactory.warningDialog("varning"); 


// dialog with custom panel 
MyCustomPanel panel = new MyCustomPanel(); 
if (DialogFactory.okCancelDialog("titel", panel)) { 
Address value = panel.getAddress(); 

// save value 

} 
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Beans binding 
startades som 
JSR 295 men har 
sedan dess 
forkats till 
BetterBeansBindi 
ng. Vi kor v£r 
egen patchade 
version av beans 
binding. 


BeansBinding 

Synkronisera honor 



For att knyta ihop presentationsmodellen med skarmen anvander vi ett 
bindningsframework som heter BeansBinding. Beansbinding anvander javas 
PropertyChange-API for att upptacka att ett fait pa ett objekt andrats och 
sedan synkronisera vardet med ett fait i ett annat objekt. 

For att andringar av vardet pa ett fait skall upptackas maste det uppfylla 
nagra krav som kommer fran en gammal java-komponent-spec som heter 
JavaBeans. Ett fait som uppfyller dessa krav kallas ibland for en property - da 
avses bade sjalva faltet, gettern och settern. 


public class MyClass { 

private final PropertyChangeSupport propertyChangeSupport 

= new PropertyChangeSupport(this); 

public static final String PROPTEXT = "text"; 

private String text; 

public String getTextO { 
return text; 

} 


public void setText(String text) { 

String oldText = this.text; 
this.text = text; 

propertyChangeSupport.firePropertyChange( 

PROPTEXT, oldText, text); 


} 


For att vara en property maste faltets getter heta getFaltetsNamn (eller 
is FaltetsNamn om det ar en boolean) och settern setFaltnamn, du skall ocksa 
deklarera en public strangkonstant som innehaller faltnamnet som heter 
PROP_FALTETS_NAMN sa att externa klasser slipper hardkoda faltets namn 
om de lyssnar efter andringar av faltet. 
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Skarmritaren holler 
tva filer i sync. En 
XML-fil som 
beskriver skarmen 
och en Java-klass 
med ett par 
segment som inte 
gar att andra 
genom NetBeans 
och som 
skarmritaren 
genererar fr£n XML- 
filen. 

Givetvis kan man 
koda med 
beansbinding utan 
att ha en 

skarmritare. Om du 
taller ut den 
genererade koden 
s£ ser du hur det 
kan se ut. 


BeansBinding 

Integration i NetBeans 

Skarmritaren i NetBeans IDE har stod for att skapa beansbinding 
bindningar mellan olika komponenter i skarmen (ett objekt kan vara en 
komponent i skarmen utan att synas). 



rMv'9*tor 


5 Form N<wJR*nel 
▼ Q Otter Component* 


I [Kursenj 


For att skarmritaren skall hitta objekten maste de skapas genom 
skarmritaren. Det gor man genom att i skarmritaren valja ’’Beans > Choose” 
Bean i paletten och sedan skriva hela klassnamnet pa klassen man behover ett 
objekt av. Darefter far man en markor for att placera komponenten i skarmen 
och da kan man klicka var man vill for att skapa komponenten. 

Nar man gjort det kommer komponenten att skapas i 
den genererade koden och dyka upp i en vy som heter 
inspector i NetBeans som visar skarmens 
komponenttrad. 


IfUpKior 


i 1 UPanel] 

— j label 1 U label] 

D vomeTeMField [ProSarvgTextFieldl 



Bind property value ijjva.Ung Object I to 
Binding Source mode* 

Binding Expression Sitextl 


Help 



Cancel 


OK 
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Formstate revisited 

Nu nar vi har automagiskt synkronisering mellan presentationsmodellen och var 
skarm kan vi dra ytterligare nytta av beansbinding genom ett speciellt formstate som 
anvander beansbindings for att upptacka nar nagot i skarmen andrats eller ar felaktigt. 

BeansBindingFormState tar en BindingGroup som argument till konstruktorn. Matisse 
skapar automatiskt en instans av BindingGroup sa fort man skapat en bindning till nagon 
egenskap for en komponent i skarmen. 

BeansBindingFormState ar ocksa integrerat med hibernate validation sa att 
bindningar i en skarm som har ett sadant formstate automatikst valideras on-the-fly och 
valideringsvarningar dyker upp som roda varningsikoner pa skarmkomponenten som 
innehaller felet. 


public AddressBookTopComponent() { 
initComponents(); 

FormState formstate = new BeansBindingFormState(bindingGroup); 
setFormState(formState); 

} 


ListState 

Ett ListState halier reda pa om nagot lagts till, tagits bort eller andrats i en lista. En 
ProSangSimpleList innehaller automatiskt ett sadant liststate efter att den initialiserats. 
ListState ar ocksa en implementation av FormState vilket innebar att du i en skarm som 
bara innehaller en lista slipper ha ett eget formstate. 


public AddressBookTopComponent() { 
initComponents(); 


setFormState(mySimpleList.getListState()); 


Substates 

Om du anvander en FormState-implementation som heter DefaultFormState kan du 
lagga till ett trad av andra formstates som substates till det. Om nagon av substatesen ar 
felaktig eller andrad sa bubblar detta upp till vart formstate. Bra for komplexa skarmar. 


public AddressBookTopComponent() { 
initComponents(); 

DefaultFormState formstate = new DefaultFormState("Main"); // N0I18N 
formstate.addSubState(new BeansBindingFormState(bindingGrou)); 
formstate.addSubState(mySimpleList.getListstate()); 
setFormState(formState); 
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Skarmens livscykel 

Eftersom det gar att skapa skarmar pa tre tusen satt ar det viktigt att topkomponenterna har 
en livscykel som ar likadan for alia skarmar sa att det ar latt att forsta hur en skarm fungerar. 
Darfor skall du implementera laddning sa har: 

Nar skarmen skapas 



Nar anvandaren sedan ar klar med skarmen och klickar Ok for att spara sina andringar skall 
skarmen alltid spara med hjalp av FinalServerOperation och PresentationModel.performFinal(). 

Presentationsmodellen kommer da att skapa en transaktion fran klienten sa att flera anrop till 
servern knyts ihop till en transaktion samt ha mojlighet att spara transaktionslog och annat som ar 
generellt for alia skarmar i hela ProSang. 
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ARKITEKTUR 

























ProSang introkurs 


DATAMODELL 



Entiteter 

databas + klasser = sant 

Ett klassiskt problem i objekt-orienterade program som jobbar mot en 
databas ar hur skall relationsdatat flyttas fram och tillbaka mellan objekt och 
databasens tabeller. 

Vi anvanderJPA for detta (Hibernate narmare bestamt). 

JPA gar ut pa att man mappar klasser mot tabeller och 
relationsdatabasstrukturen. For att kunna anvanda JPA kravs att man for varje 
post i varje tabell som skall mappas har ett unikt id. I alia nya tabeller 
anvander vi ett helt syntetiskt id fran en oraclesekvens. 


@Entity 

@Table(name = "ADDRESS") 
public class Address { 

(aid 

(aColumn (name = "ID") 

@GeneratedValue(strategy = GenerationType.AUTO) 
private long id; 


(aColumn (name = "NAME") 
private String name; 


For att jobba mot databasen anvander man sedan en EntityManager som 
innehaller metoder for att lasa, skriva, ta bort och soka efter entiteter. Man 
anvander ett speciellt query-sprak som heter JPQL for att soka efter 
entiteter som innehaller en del finesser som inte finns i SQL men i ovrigt ar 
ganska snarlikt. 


EntityManager em = ... 

Query query = em.createQuery("SELECT a FROM Address a"); 
List<Address> allAddresses = query.getResultList(); 

query = em.createQuery("SELECT a FROM Address a " + 

"WHERE a.name = :name"); 
query.setParameter("name", "Testa Testsson"); 

Address result = query.getSingleResult(); 
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Serializable 

En inbyggd finess i Java ar formagan att serialisera en objektgraf till XML 
eller tvartom. Finessen anvands av Java RMI (Remote Method Invocation) som i 
sin tur ar det satt en klient pratar med en Java EE server over natverket. 



For att ett objekt av en klass skall ga att serialisera maste det implementera 
ett markup interface som heter Serializable. Det maste ocksa ha ett versionsfalt 
for att veta att klassen som objektet serialiserades ifran ar likadan som klassen 
som objektet avserialiseras till.Versionsnummret maste uppdateras varje gang 
du andrar entitetens fait pa nagot satt. Om du andrar metoderna behover du 
inte rakna upp versionsnummret. 


Att klassen ar 
serializable ar 
inte direkt 
kopplat till just 
natverkskommu 
nikation utan 
innebar att 
objekten kan 
skrivas som 
XML till vilken 
strom som heist. 
T.ex. for att 
skriva en lista 
med objekt till 
en fil p3 
harddisken. 


public class Address implements Serializable { 
private static final long serialVersionUID = 1L; 
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PersistenceContext 

Attached/Detached 

En mycket viktig skillnad mellan JPA och att lasa och skriva data med SQL ar 
begreppet attached.JPA halier ett cache som lever under hela transaktionen. 
Om samma entitet lases flera ganger kommer alia referenser som man far ut 
peka pa samma instans av entiteten. 

Sa lange entiteten ar attached kommer ocksa alia andringar som gors pa den 
att skrivas tillbaka till databasen nar transaktionen committas. 


EntityManager em = ... 

em.getT ransaction().begin(); 

Address addressl = em.find(Address.class, 1); 
Address address2 = em.find(Address.class, 1); 
// addressl == address2 

addressl.setName("Nytt namn"); 
em.getT ransaction().commit(); 


Det innebar alltsa att man inte kan lasa ut en entitet och sedan anvanda den 
som nagon form av temporarlagring (varfor man nu skulle gora det) eftersom 
de andringar man gor alltid skrivs tillbaka till databasen. 

Om man sparar en ny entitet med EntityManager.persist sa kommer 
objektet man skickade in till persist att vara attached efter anropet. Om man 
sparar en gammal entitet med EntityManager.merge sa kommer objektet man 
skickade in till merge inte att vara attached, daremot sa kommer det sparade 
och attachade objekt returneras. 


EntityManager em = 



em.getTransaction( 

).begin(); 

Address addressl = 

new 

Address(); 

em.persist(addressl); 


addressl.setName(" 

Nytt 

namn"); 

em.getTransaction( 

).commit(); 


Nar ett objekt serialiseras sa kommer det automatiskt att bli detached. 
Objekten serialiseras alltid nar de skickas fram och tillbaka mellan server och 
klient. 
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Relationer 

LazylnitializationException 

Halva poangen med relationsdatabas ar ju att ha relationer mellan olika 
tabeller.Att varje gang man laddar en entitet lasa ut alia entiteter den har 
relationer med ar inte sa bra darfor lazy-laddas de fiesta relationer i ProSang. 

Om man inte annoterar en relation med nagot sa tolkar hibernate det som 
att relationen skall lazy-laddas. 



Employee 


@Entity 

public class Company { 

@0neToMany 

private List<Employee> employees = new ArrayListO; 



Sa lange en entitet ar attached sa laddar hibernate automagiskt relationer 
forst nar man faktiskt anvander dem. Om enteteten ar detached kan har inte 
hibernate langre nagon kontakt med enteteten och man far darfor en 
LazylnitializationException. Det innebar att alia relationer som behovs pa en 
entitet maste laddas innan den skickas till klienten. 


EntityManager em = ... 

Query query = em.createQuery("SELECT c FROM Company c " + 

"WHERE c.name = :name"); 
query.setParameter("name", "Databyran"); 

Company company = query.getSingleResult(); 

List<Employee> employees = company.getEmployeesO; 

// lazy load does not happen until here 
int numberOfEmployees = employees.size(); 
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Transaktioner 

JavaEE/JavaSE 

Nar man anvanderJPA i JavaSE maste man skota start, commit och rollback 
av transaktionen sjalv. I vara tester anvander vi JPA i JavaSE miljo men for att 
slippa tanka pa transaktionerna sa anvander vi ett lite fardiga finesser fran 
JeeSUnit for att fa en ny transaktion i varje test och en rollback efter varje test. 
Om man kodade en JPA-applikation pa JavaSE skulle man fa lov att gora: 


EntityManager em = 


em.getTransaction() 

■ begin(); 

em.getTransaction() 

.commit(); 

em.getTransaction() 

.rollback(); 


I JavaEE skots transaktionerna av applikationsservern om vi inte annoterar 
vara EJB.er pa ett speciellt satt.Applikationsservern rullar tillbaka transaktionen 
om en EJB-metod kastar ett exception. For manga skarmar anvander vi nu en 
speciell ServerOperation som startar en transaktion fran klienten och knyter 
ihop flera serveranrop i samma transaktion. 

Man kan styra hur EJB-metoderna vill ha sina transaktioner med 
annoteringar men vi gor sallan det. 
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PS nagot stalle i 
ProSang 
anvander vi 
pessimistisk 
lasning. T.ex. for 
att garantera att 
det inte blir hal i 
tappningsnumme 
rserierna. 


Optimistisk ISsning 

Skydd mot samtidiga andringar 

Om tva anvandare laser ut samma databaspost och sedan sparar andringar 
sa kommer den som sparar sist skriva over den forsta anvandarens andringar 
utan att nagon marker nagot. 

For att komma runt problemet finns tva losningar. 

Pessimistisk lasning innebar att den forsta anvandaren som laser 
posten laser den sa att ingen annan kan lasa posten forran anvandaren ar klar 
och last upp posten. 

Optimistisk lasning innebar att man pa nagot satt halier koll pa hur 
manga ganger en post skrivits eller nar en databas post senast skrevs. Innan 
man skriver tillbaka sina andringar jamfor man sin post med den i databasen, 
har den samma antal andringar alternativt samma andringsdatum? Da har ingen 
andrat posten och det gar bra att uppdatera. Om antalet skrivningar raknats 
upp eller datumet andrats till ett senare datum sa har nagon annan gjort 
andringar och vi maste avbryta skrivningen. 

IJPA finns stod for bade datum och versions-losningen.Vi anvander 
versionslosninen.Alla nya tabeller i ProSang har alltsa en versionskolumn som 
raknas upp varje gang en post andrats. 


@Entity 

@Table(name = "ADDRESS") 

public class Address implements Serializable { 


(aversion 

private long optlock; 


I praktiken sa skapar vi nastan aldrig versionsfaltet sjalva utan far det fran en 
basklass som heter DefaultEntity (som ocksa ser till att alia entiteter har ett 
long-id, skapad-data och senast-andrad-data och en propertyChangeSupport). 


@Entity 

@Table(name = "ADDRESS") 

public class Address extends DefaultEntity 

implements Serializable { 
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Unittester a v datamodellen 

Veta att det fungerar utan deploy 

For att kunna testa att datamodellens klasser ar ratt mappade, att queryn 
fungerar sa anvander vi en SQL-databas som skapas av ett testframework som 
heter Jee5Unit. SQL-databasen skapas i arbetsminnet pa din dator da det forsta 
entitetstestet kors och kastas sedan bort nar alia tester ar klara. 

Ovanpa Jee5Unit har vi skapat ett par basklasser for test som satter upp 
lite extra data for ProSang (bland annat en fejkad inloggad anvandare). 

Unittester som testar en entitet genom att lasa och skriva den till databas 
skall heta Klassnamn + EntityTest. 


Jee5Unit ar 
skrivet av Johan. 
Mer info och 
exempel p3 hur 
man kan anvanda 
det finns pa 
projektsiten: 


public class AddressEntityTest extends EntityTest { 
@Test 

public void testIsPersitableAndReadable() { 
EntityManager em = getEntityManager(); 

Address instance = new AddressO; 
instance.setName("Nisse"); 
em.persist(instance); 

em.flush(); 
em.clear() ; 

Address persisted = em.find(Address.class, 

instance.getld()); 

assertNotNull(persisted); 

} 


Eftersom vi inte kan gora commit pa transaktionen (och potentiellt gora sa 
att andra tester slutar fungera) sa far vi lov att gora lite knep. 
EntityManager.flush() tvingar Hibernate att gora om vara andringar till SQL och 
trycka dem ut till databastransaktionen, pa sa satt fangar vi upp eventuella 
exceptions som ar en foljd av att vi mappat entiteten felaktigt pa nagot satt. 

EntityManager.clear() tar bort alia objekt i persistence-contexten sa att vi ar 
sakra pa att nar vi sedan laddar den sa laddas den fran databasen. Om vi inte 
gjorde det skulle EntityManager.find() i exemplet ovan bara returnera en 
referens till instance. 
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Validering 

For att kunna lita pa databasens innehall behover allt data man far in 
valideras. Istallet for att koda sadana krav pa alia platser data kan komma in i 
ProSang anvander vi ett valideringsframework som heter Hibernate Validation 
och som ar tatt knutet till Hibernate. 

Pa entiteternas fait kan man annotera krav som kommer att undersokas 
automatiskt i skarmarna dar beans binding anvands. Faltens data matchas ocksa 
mot kraven innan en entitet skrivs till databasen. Om nagot fait ar felaktigt nar 
databasskrivningen skall ske kastar Hibernate ett exception som rullar tillbaka 
transaktionen. Det blir alltsa i praktiken omojligt att spara felaktigt data genom 
ProSang. 

Faltkraven annoteras till skillnad fran entitetsannoteringarna pa faltets get- 
metod. 


@Entity 

public class Address extends DefaultEntity { 
^Required 

private String name; 

@Length(max = 255) 

@Column(name = "NAME") 
public String getNameO { 
return name; 

} 


Annotering 

Beskrivning 

@ Required 

Faltet maste ha ett varde - far inte vara tomt 

@Length(min = , max = ) 

Krav pa hur manga tecken som far vara i en 
strang 

@Max(value=) 

Krav pa hur hogt ett tal i en strang eller ett 
numeriskt fait far vara 

@Min(value=) 

Samma som ovan fast minsta varde 


Las om fler inbyggda valideringsannoteringar har: 

http.7/docs.jboss.org/hibernate/validator/3.x/reference/en/html/validator-defineconstraints.html 
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Databasschemat 

XML-representation 

ProSang har vid varje version ett exakt databasschema som matchar de 
entiteter som finns i datamodellen. For att garantera att det ar sa anvander vi 
ett opensource-bibliotek som heter LiquiBase 

Losningen fungerar sahar: varje gang en databastabell skall skapas eller 
forandras skapar man ett nytt ’’changeset” i XML som beskriver en eller flera 
forandringar av databasschemat pa ett databasoberoende satt. Changeset:et har 
ett unikt id som bestar av ditt anvandarnamn samt ett strangid och xml-filen 
som det ligger i. Med hjalp av det halier liquibase koll pa exakt vilka andringar 
som applicerats och vilka som ar nya. 

Liquibase kan ocksa rulla tillbaka (manga) andringar i efterhand sa att det ar 
mojligt att kora sin andring, upptacka att man gjort fel, rulla tillbaka och ratta 
sin andring nar man sitter och utvecklar. 

For att hjalpa till da man skapar changesets har vi ett eget netbeansplugin 
som gor att man kan hogerklicka pa en entitet och fa ut ett LiquiBase- 
changeset som beskriver hur tabellen skall se ut. 


& Database Schema Autopatch 

► Qj Source Packages 

► Qj Test Packages 
▼ Cd Other Sources 

▼ Cd src/main/resources 

► [d META-WF 

► 9Q se.databyTan. prosang. server.autopatch. postpatch 

► 99 se.databyran.prosang.server.autopatch.sql.patches 
▼ 9j se.databyran.prosang.server.dbschema 

t>] changek)g-2011.5.1.xml 
^3 master.xml 


For att 

sakerstalla att 
schemauppdateri 
ngen gatt klart 
innan ProSang 
startar kors 
schemauppdateri 
ngen med hjalp 
av egna JBoss- 
services som 
sedan alia 
fasadbonor har 
ett beroende p£. 


Mer information om pluginet hittar du pa wikin: http://wiki.databyran.se/ 
display/psdev/Databasschemahantering 
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Databasschemat 

eprecated :Generera DDL fr£n klasser 

Det har galler ProSang fore version 2011.5 da vi gick over till LiquiBase (se 
foregaende sida). Det ar kvarlamnat som en referens. 

ProSang har vid varje version ett exakt databasschema som matchar de 
entiteter som finns i datamodellen.Vi kan generera DDL fran annoteringarna i 
vara klasser men vi kan inte applicera dem automatiskt. En del 
databasschemadetaljer som t.ex. index finns dessutom inte alls i entiteterna och 
maste laggas till for hand. 

Losningen fungerar sahar: varje gang en databastabell skall skapas eller 
forandras skapar man en ny databasschemapatch som placeras i en speciell 
katalog. Nasta gang ProSang deployas pa servern kommer patchen koras. Ett 
speciellt bibliotek halier reda pa vilka patchar som gatt och vilka som ar nya sa 


* 

T 


► 

► 


m 

05 Source Packages 
05 Test Packages 
OR Other Sources 
▼ C3 src/mam/resources 
► LLi <default package > 


..Core Utilities 

msssmSM 


► fi META-INF 

▼ se.databyran.prosang.server.autopatch.sql.patches 
[j patch, list 

£ patchOOOljninal-schema.sgl 
j£ patch0002_blood bank view.sql 
[£ patch0003_cl«ent-settings-lite.sql 
«[ patchOO 14code-definitionsql 
jd patch001S_bloodbank-donationsite.sql 
d_ patch0016_donor.sql 
j£ patch0017_alert-code-definitk>n.sql 
patchOO 18 alert.sql 
patchOO 19_propchange sql 
d_ patch0070_enum-definition.sql 
j£ patch0021_donor-extended.sql 

patch0022 donor-additional-donation-site.sql 
patch0023_donor-additiorval-donor-tvpe.sql 
_d patch0024_donor-invitationrules.sql 
£ patch002S_cbentsetnngs.sql 
j£ patch0026_person-identity.sql 
£ patch0027 global-alert.sql 


For att generera databasschema fran datamodellen hogerklickar du pa 
datamodellsprojektet, valjer ’’Custom > Generate DDL”, maven kommer da 
generera en DDL for hela datamodellen som dels skrivs ut i NetBeans 
logfonster och dels hamnar i en fil. 

Du far sjalv leta fram de andringar du skall ha i din patch. 
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Fasadbonor 

Lasa och skriva entiteter utifrSn 


«lnterface» 
GenericFacade<E, l> 

L «Abstract» 1 

J 1 GenericFacadeBean<E, l> 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

| AddressFacadeLocal | 

|<]---|^AddressFacadeBean | 


For att undvika att logik som laser och skriver entiteter sprids genom hela 
ProSangservern har varje viktig entitet en fasadbona som resten av ProSang anvander for att 
lasa och skriva entiteter av den typen. Eftersom JPA:s querysprak inte ar typsakert ger det 
ocksa ett extra skydd vid refaktorering - det ar hyffsat latt att hitta alia JPQL-queries som 
gors mot en specifik entitet. 

Ett antal operationer (CRUD) ar generella och finns fardigimplementerade i en abstrakt 
basklass som heter GenericFacadeLocal. Metodsignaturerna for dessa finns ocksa i ett 
generellt interface som du later ditt EJB-interface uttoka. 

Krangligare operationer som sokningar t.ex. ges en egen metod i fasad-EJB:n. 

Fasad-EJB.erna ar alltid bara lokala och kan inte anropas fran en extern klient till 
ProSangservern. 


@Local 

public interface AddressFacadeLocal extends GenericFacade<Address, Long> { 
List<Address> findSpecialAddresses(); 

} 

@Stateless 

public class AddressFacadeBean extends GenericFacadeBean<Address, Long> 

implements AddressFacadeLocal { 
public List<Address> findSpecialAddresses() { 

} 

} 
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AFFARS 




Affarslogiken ar det som knyter ihop flera fasadboneanrop till 
affarsmetoder som publiceras till klienten. Ibland kan affarslogiksbonorna till 
en borjan vara enkla delegat som bara upprepar metoder fran fasadbonorna. 
Ofta kan det vara bra att knyta ihop upprepade anrop av en fasadbona till ett 
enda anrop pa en affarslogiksbona. 

Fasadbonorna som en affarslogiksbona anvander injiceras automatiskt av 
applikationsservern nar vi annoterar dem med @EJB 

Alla vara affarslogiks EJB:er ar remote-bonor och maste darfor annoteras 
med en behorighetsannotering som styr vem som far anropa dem. Med nagra 
fa undantag kraver alia vara remote-EJB.er att man klienten ar inloggad och 
annoteras darfor med krav pa rollen ’’user” (om man inte annoterar sin EJB 
med behorighet kan vem som heist ropa pa metoderna i den). 


@Remote 

public interface AddressRemote { 

/** 

* Save all addresses in the list and return true 

* if the save was successful 

*/ 

boolean saveAddresses(List<Address> addresses); 

} 


@Stateless 

@RolesAllowed("user") 

public class AddressBean implements AddressRemote { 

@EJB 

private AddressFacadeLocal addressFacade; 

public boolean saveAddresses(List<Address> addresses) { 
for (Address address : addresses) { 
if (address.getld() == 0) { 

addressFacade.insert(address); 

} else { 

addressFacade.update(address); 

} 

} 

return true; 

} 

} 
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Unittester av affarslogiken 

Testa utan datamodellen 

Nar man testar affarslogiken sa vill man inte att testerna skall fela pa grund 
av ett fel i en fasadbona. Man vill faktiskt bara testa just den logik man skrivit i sin 
affarsmetod. 

For att astadkomma ett sadant test anvander vi ett mock-framework som 
heter JMock som fungerar lite som en skadespelare. Man ger ett interface till 
JMock och sager, latsas att du ar en implementation av det har interfaces. Sedan 
ger man ett manus (Expectations) till JMock dar man beskriver hur man 
forvantar sig att nagon kommer anvanda implementationen. 

For att fa sin skadespelarklass injicerad i sin EJB-klass som om den var 
deployad pa en applikationsserver later vi vart test arva EJBTestCase och 
anvander metoderna injectEJBQ samt getBeanToTestQ. 


public class AddressBeanTest extends EJBTestCase<AddressBean> { 

public void AddressBeanTest { 
super(AddressBean.class); 

} 

@Test 

public void testSaveAll() { 

Mockery mockery = new MockeryO; 

final AddressFacadeLocal mockedAddressFacade = 

mockery.mock(Add ressFacadeLocal.class); 

List<Address> addresses = new ArrayListO; 
addresses .add(new AddressO); 
addresses.add(new AddressO); 

mockery.checking(new Expectations() { 

{ 

exactly(2).of(mockedAddressFacade). 

save(with(any(Address.class)); 
will(returnValue(Boolean.TRUE)); 

} 

} 

injectEJB(AddressFacadeLocal.class, mockedAddressFacade); 
AddressBean instance = getBeanToTest(); 

boolean result = instance.save(addresses); 

assertTrue("Expected save to return true on success", result); 
mockery.assertlsSatisfied(); 
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UTSKRIFTER 

ProSangs utskriftspaket anvander iReports/JasperReports som ar ett 
rapportverktyg som ar integrerat med NetBeans. Man ritar alltsa sina 
utskrifter inuti NetBeans. 

Kring utskrifter finns ett par viktiga begrepp: 

• rapporttyp en klass som innehaller logiken som tar fram och 
forbereder data for rapporten, klassen innehaller ocksa en lista med de 
rapporter som man kan anvanda for att skriva ut rapporttypen 

• rapport sjalva layouten for en utskrift, kan finnas flera for en 
rapporttyp 

• utskrift data fran en rapportklass kombinerat med en rapport fardigt 
for att skriva ut. 

• ReportRequest knyter ihop en rapporttyp, vilken rapport som skall 
anvandas samt eventuella parametrar till rapporttypen (t.ex. vilken givare 
som skall skrivas ut) 

Klienten ropar pa PrintRemote med en ReportRequest och servern 
generar sedan utskriften som den skickar tillbaka till klienten sa att utskriften 
koas genom klientendatorns utskriftssystem. Servern kanner alltsa inte till 
nagot om vilken skrivare som anvands. 

Rapporttyperna och rapporterna finns i modulen Server Print Package. 


▼ ^ Server Print Package 

▼ uU Source Packages 

► m se. databyfan.prosang.se ever, printing 

► tfcj se.databyran.prosang.server.printing.donation 

▼ ffi 

iS Dona t *>niabeIsControIRe port.java 
dtj DonationLabelsNewDonorReport.java 
DonationLabelsNewDonorRequest.java 
&] DonationLabelsReport.java 
DonationtabelsRequestjava 
at] DonatonlablesControlRcquest java 
i] package-lnfo.java 

► se.databyran.prosang.server, printing.donation.lists 

► a se.databyran. prosang. server, printing.donor 

► s se.databyran. prosang.se rver.printing.donor.letter 

► a se .databyran. prosang. se rver. printing.dynamic 

► £ se. databyran. prosang. server, printing.renderer 

► fcfj se.databyran. prosang. server, printingtest 
► UJ Test Packages 

▼ Cd Other Sources 

▼ src/mam/resources 

► t±j <default package> 

► @ META-INF 

► ® reports 

► reports.Common 

▼ reports.DonationLabels 
[_j Donattonlabels.jrxml 


se.databyran. prosang. server.printir*g.donatk>n.donatK>nlabels 
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TRANSAKTIONSLOG 



I ProSang behovs valdigt finkornig sparbarhet pa andringar. Alla operationer 
som maste vara sparbara skrivs till transaktionsloggen. Operationer som skall 
var sparbara kan vara att ett visst fait pa en entitet andrats, att en rapport 
skrivits ut eller att anvandaren forcerat nagon form av varning. 

Datamodellen 

Entiteter kan sjalva halla reda pa om vissa fait andrats. Genom att sedan lata 
dem implementera SelfLoggingEntity kan man skicka sjalva instansen till 
fasadbonan LogFacade. Man kan t.ex. gora det fran insert och update pa 
fasadbonan for entiteten. 

Den har typen av loggning ar enklast att implementera for rot-entiteter 
som man alltid jobbar direkt med. Entiteter som sparas med cascade ar svart 
att hantera pa detta satt. 

Affarslogiken och fasadbonorna 

Man kan skapa Logltems direkt i sin kod pa servern och skicka till 
LogFacade. 

Klienten 

I klienten vill man oftast bara spara Logltems om anvandaren sparar sina 
andringar. Darfor ar det bast att skapa en LogHandler i sin presentationsmodell 
som man sedan ger Logltems nar saker som skall transaktionsloggas hander. 
Nar sedan skarmen kor sin FinalServerOperation sa ger man listan med 
logitems fran sin LogHandler till sin FinalServerOperation sa sparas de 
automatiskt. 


40 



ProSang introkurs 




I ProSang har funktionstester som testar hela applikationen fran 

anvandargransnitt i klienten ner till databasen genom en deployad server. 
Testfallen skrivs som vanliga unittester i modulen Client Modules/Client 
Application. 

Testerna fungerar som om det var en anvandare som korde systemet. 
For varje swing-komponent finns en Operator-klass som vet hur man 
jobbar med en sadan komponent. 
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JBOSS 



Hos varje kund ar forutsattningarna for integration med andra system och indatakallor olika. 
Det kan t.e.x. vara vad kunden koper for typ av utgaende SMS-tjanst, olika SMS leverantorer har 
helt olika satt att skicka SMS. Nagon har en webtjanst, nagon har en HTTP-server som tar 
meddelandet som GET argument i en URL. 

For att slippa gora en version av ProSang per kund ar denna integration externaliserad med 
hjalp av JBossESB (JBoss Enterprise Service Bus).Varje ingaende och utgaende datakoppling ar en 
"tjanst” som deployas pa JBoss-servern. ESB-tjansterna kataloger istallet for jar-arkiv och laggs 
precis som allt annat som deployas pa en JBoss-server i deploy-katalogen. 


ProSang 2008.8 


EZ3 


EjbXxx 


EjbYyy 




EjbYyy 


I ^ 


i n 


DonorAdministrationBean 


■=p 

i—b 


ResultatRegistret 


ProSang-outgoing-connections 


JBoss ESB 

I 


J PersonLookup- PersonLookup 


\~2 


Bean 


reiduiiLuuKup 1 1 1 

Message r —'—P 


erson-lookup.esb 
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En ESB-tjanst borjar med en gateway dar data kommer in pa nagot satt. 
Det kan vara en webbtjanst, en katalog dar filer placeras, en plats pa en FTP- 
server dar filer placeras, m.m. Man kan ocksa explicit anropa en viss ESB fran 
sin javakod.Alla sadana anrop sker i ProSang ifran lokala EJB:er i prosang- 
outgoing-connections.jar sa att sjalva ProSang inte behover kanna till JBossESB 
pa nagot satt. 

Efter detta bestar ESB-tjansten av en eller flera Actions som skall bearbeta 
datat eller publicera datat nagonstans. Exempel pa en action kan vara XSLT- 
transformation av XML, att skriva till ett loggningsarkiv eller anvanda datat 
som argument till ett EJB-anrop. Ett antal fardiga ESB-actions ar inbyggda i 
JBoss ESB och vi har ett eget bibliotek med nagra egna actions. I forsta hand 
anvander ESB-tjanster fardiga actions som konfigureras pa olika satt. 

* 



<■ 


SMS-leverantor 

— 


▼ y prosang-sms.esb 
► L examples 
▼ META-INF 

o deployment.xml 
[•I jboss-esb.xml 


En ESB-tjanst bestar i filsytemet av en katalog som 
slutar pa .esb i den finns en META-INF-katalog som i sin 
tur innehaller filen jboss-esb.xml som innehaller tjalva 
tjanstekonfigurationen och ibland deployment.xml som 
listar tjanstens beroenden pa andra typer av tjanster i 
samma server. 
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JBOSS-ESB 




Det har exemplet ar ProSangs utgaende SMS-koppling. Attributet invmScope sager at JBoss 
ESB att skapa en ingaende kanal for anrop fran samma JVM, det ar den kanalen vi ropar pa fran 
prosang-outgoing-connections. 


<?xml version = "1.0" encoding = "UTF-8"?> 

<jbossesb 

xmlns=" http://ancnsvn.labs.iboss.com/labs/ibossesb/trunk/product/etc/schemas/xml/ 
1bossesb-1.0.1.xsd " 

parameterReloadSecs="5"> 

<! - - 

This is an example format that just writes the SMS request to an archive in 
the tmpdir of the machine the server runs on. 

This is meant for testing on devel machines. See examples/ for actual 
production configuration samples. 

- - > 

<services> 

<service category="ProSang n 
name= M SMS" 

description= M ProSang outgoing SMS service" 
invmScope="GLOBAL"> 

<!-- the mep attribute is what JBoss ESB looks at to know if we 

extect some kind of status/answer when the service has handled 
a message --> 

<actions mep="OneWay"> 

<action name="debug 11 class="org. j boss. soa. esb. actions. SystemPrintln"> 
<property name="printfull" value= M false M /> 

<property name="message" value="Value from getMessage" /> 
</action> 


<!-- Transform the ProSang-Java SMS object into XML --> 

<action name="transformToXML" 

class="org.j boss.soa.esb.actions.converters.Obj ectToXStream"> 
<property name="exclude-package M value="true" /> 

</action> 


<!-- archive message under your tmp directory --> 

<action name="archive" 

class="se.databyran.esb.actions.ArchiveWiretap"> 

<property name="baseDirectory" value="${ProSangHome}/archive"/> 
<property name="serviceName" value="outgoing-sms"/> 

</action> 

</actions> 

</service> 

</services> 

</jbossesb> 
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API O' 



I ProSang finns sjutusen olika sma APker for olika saker. Har ar nagra: 

Finder-API 

API for sokdialoger som anvands for att valja t.ex.givare att oppna i ett 
program eller tillsammans med ProSangFinderField i en skarm dar man vill 
kunna valja en entitet bland manga. Ligger i Client Modules/Core Cluster/Core 
Search API. Exempel pa implementationer finns i Client Modules/Donor 
Cluster/Donor Common 

Sokparameter-API 

API for att representera ett JQPL-sokargument med en klass som kan 
kombineras med andra sdkargument som soker efter samma typ av entitet. 
Ligger i datamodellen i paketet se.databyran.prosang.model.core.search och 
exempel pa implementationer finns i se.databyran.prosang.model.donor.search. 

Matchat med detta finns ocksa ett sokpanels-API i klienten som gor att man 
enkelt kan skapa ett program som tillater anvandaren att kombinera enskilda 
sokparametrar till mer komplexa sokningar. Det kan du hitta i projektet Client 
Modules/Core Cluster/Core Dynamic Search API 

Notifierings-API 

API for att visa att en Swing-komponent innehaller felaktiga varden. Ligger i 
ProSang Libraries/ProSang GUI-lib dar bade API och ett antal implementationer 
ligger. Innehaller interfacet Notifiable som BeansBindingFormState anvander for 
att varna om fel och som du ocksa anvander om du vill kunna utfora mer 
komplex validering i din presentationsmodell. 


Presentationsmodells-API 

Basklasser for presentationsmodeller. Ligger i Client Modules/Core Cluster/ 
Core Util 

DateSpan och Datum-API 

API for att jobba med datum och tidsperioder. Ligger i ProSang Libraries/ 
ProSang Utils. Intressanta klasser ar DateUtil, DateFormatUtil och DateSpan. 

EntityDisplayer-API 

SPI for att utan att kanna till vem som visar en entitet be nagon annan att 
visa den. Gor det mojligt att registrera en EntityDisplayer for en viss 
entitetsklass for andra att anvanda. Ligger i Client Modules/Core Cluster/Core 
Util och paketet se.databyran.prosang.client.core.util.spi 
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